home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / CLPMOUSE.ARJ / MS_MOUSE.DOC < prev    next >
Text File  |  1991-06-18  |  6KB  |  181 lines
  1. MS_MOUSE.LIB v1.0, another fine offering from Staben Technologies complementing
  2. ------------       the CLIPPER(tm) of both Shareware and Public Domain.
  3.  
  4.  
  5.             MS_MOUSE.LIB
  6.             (c) Staben Technologies
  7.             c/o Matthew Staben
  8.             811 West 14th Avenue
  9.             Spokane, WA  99204
  10.             (509) 747-5600
  11.             
  12.             
  13. <<Shareware:>>
  14.  
  15. MS_MOUSE.LIB is NOT "free".  It is user-supported "shareware" and for continued
  16. use, a license is required.  Since this library is a "programmer's aid" rather
  17. than a complete package some weird provisions have been taken care of.  
  18.  
  19. <<Licensing:>>
  20.  
  21. When a license is bought, MS_MOUSE.LIB can be used freely by the one person who
  22. purchases the license.  MS_MOUSE.LIB may exist on many different computers, as
  23. long as each "programmer" is then licensed to access the MS_MOUSE.LIB.  The
  24. executable resulting from adding MS_MOUSE.LIB to your code is royalty free.  It
  25. may be copied, shared, destroyed at the wish of the "programmer."  Once you are
  26. licensed to access MS_MOUSE.LIB, you may modify, change, mangle, spindle the
  27. "object" as much as desired, as long as it is not for profit.  
  28.  
  29. Before the said license is bought, the "programmer" may distribute any code
  30. which uses MS_MOUSE.LIB as long as the said programmer is licensed within 
  31. fifteen (15) days of distribution.
  32.  
  33. The license for each "programmer" who will access MS_MOUSE.LIB is $15.00.  
  34. When doing orders with more than one license, apply the following formula 
  35. to calculate your licensing cost:
  36.  
  37. ((no_licenses) * 15.00) - ((no_licenses - 1) * 3)
  38.  
  39.      15.00    for one license, save $0.00
  40.     27.00   for two licenses, save $3.00
  41.     39.00   for three licenses, save $6.00
  42.     51.00   for four licenses, save $9.00
  43.     
  44. No jokes, folks!  Each license comes with a 1-year upgrade, if any, and for an 
  45. additional $10.00 - $50.00, additional "libraries" to supplement the features
  46. (such as support for TBROWSE()) may be requested from Staben Technologies.  
  47.  
  48.  
  49. <<Disclaimer:>>
  50.  
  51. Staben Technologies does not guarantee, or attest to, the fitness, 
  52. merchantability of this code.  It does, however, guarantee that it will work
  53. on the following types of equipment:
  54.  
  55. 1. IBM xt or *standard* clone with,
  56. 2. VGA or EGA monitor with video-character RAM.
  57.  
  58.  
  59. MS_MOUSE.LIB will *NOT* work for any systems which are monochrome, non EGA/VGA
  60. compatible.
  61.  
  62. <<Whatsit?:>>
  63.  
  64. MS_MOUSE.LIB is a library of mouse functions for CLIPPER (tm) 5.1 users, 
  65. featuring:
  66.  
  67. 1. Pixel-by-Pixel arrow-cursor movement on alphanumeric screens.
  68. 2. Pixel/Row-Column return values.
  69. 3. Quick Action.  Programmed in pure assembly language.
  70.  
  71.  
  72. <<Syntax of MS_MOUSE.LIB>>
  73.  
  74. In order to use MS_MOUSE.LIB, the MS_MOUSE.LIB must be made available as a 
  75. library to your linker.  MS_MOUSE.LIB may be moved into another library, 
  76. extracted, whatever, as you see fit.
  77.  
  78. MS_MOUSE.LIB is dependent on the "MICKEYSOFT"-MOUSE drivers, or their 
  79. compatibles!  
  80.  
  81. FUNCTION    RETURNS
  82. ========    =======
  83.  
  84. MS_ON(expN)    <- "ON"
  85.  
  86.     Turn on mouse cursor.  MS_ON() will put a cursor at the last position
  87.     it was on the screen.  If MS_ON() is the initial "turn-on", the cursor
  88.     will appear at the top-left corner of the screen, at coordinates 0,0.
  89.     MS_ON() may only be used if MS_OFF() has been invoked, or it is the
  90.     first time being invoked.  
  91.     
  92.     The parameters, 0 or 1 are required.  If "0" is used, the screen is
  93.     assumed to be an 80x25 mode screen.  If "1" is used, the screen is
  94.     assumed to be an 80x43/50 mode screen.
  95.     
  96.     ie,    MS_ON(0)    <-    "ON" - 80x25
  97.         MS_ON(1)    <-    "ON" - 80x50
  98.     
  99.  
  100. MS_OFF()    <- "OFF"
  101.  
  102.     Turn off mouse cursor.  MS_OFF() will remove the cursor from the screen
  103.     and halt all processing of mouse movements.  MS_OFF() may only be used
  104.     if MS_ON has been invoked.  
  105.     
  106.  
  107. MS_XPPOS()    <- expN
  108.  
  109.     Retrieve X-Pixel Position.  MS_XPPOS() will return to a Clipper(tm) 
  110.     variable the current X position in PIXELS.  MS_XPPOS()'s results
  111.     can only be relied upon if MS_ON() has been invoked and is active.
  112.     The pixel position is the location of the tip of the arrow cursor.
  113.     
  114. MS_YPPOS()    <- expN
  115.  
  116.     Retrieve Y-Pixel Position.  The same conditions as MS_XPPOS() apply.
  117.     
  118. MS_XPOS()    <- expN
  119.  
  120.     Retrieve X-Column position.  MS_XPOS() will return to a Clipper(tm)
  121.     variable the current X position by columns as defined on the
  122.     alphanumeric screen.  MS_XPOS()'s results can only be relied upon
  123.     if MS_ON() has been invoked and is active.  The X position is the
  124.     cell pointed to by the tip of the arrow cursor.
  125.  
  126. MS_YPOS()    <- expN
  127.  
  128.     Retrieve Y-Column position.  The same conditions as MS_XPOS() apply.
  129.     
  130. MS_BPOS()    <- expN
  131.  
  132.     Retrieve button status.  MS_BPOS() will return to a Clipper(tm)
  133.     variable the current button status.  MS_BPOS()'s results can only be
  134.     relied upon if MS_ON() has been invoked and is active.  
  135.     
  136.             Left button  = 1
  137.             Right button = 2
  138.             Both buttons = 3.. etc. (this sample for mickeysoft)
  139.     
  140.     
  141. <<Last Word:>>
  142.  
  143. These routines are of version 1.0 of the "CLIPPER(tm) MOUSE" series by
  144. Staben Technologies.  Staben Technologies is a supporter of CLIPPER(tm), and 
  145. will continue to produce quality works in order for those who use CLIPPER(tm)
  146. to find and expand their power and knowledge.  Staben Technologies has a 
  147. series of PUBLIC DOMAIN programs out for CLIPPER(tm) 5.0 and 5.1.  These are:
  148.  
  149. Clipper(tm) Windows    -    Memory-free windowing, written entirely in
  150.                 CLIPPER(tm) code.  Objects only distributed.
  151.                 * Included in this package *
  152.                 
  153. Keyboard Interrupt    -    Interrupt your clipper(tm) program, stuff a key
  154.                 and trap it with your SET KEY procedure!
  155.                 Program it for continous, every second, every
  156.                 10 seconds, etc...
  157.  
  158. Get Real Environment    -    Clipper(tm) maintains a bogus copy of the 
  159.                 environment.  Any changes to it are not
  160.                 reflected by the built-in functions provided!
  161.                 This will return the REAL environment.
  162.                 
  163.  
  164.  
  165. Please write to Staben Technologies for any comments, requests, hints, or
  166. just plain thanks at any time.
  167.  
  168.             Matt Staben, Programmer
  169.             Staben Technologies
  170.             811 West 14th Avenue.
  171.             Spokane, WA  99204
  172.             (509) 747-5600
  173.             
  174.  
  175. Staben Technologies will take requests for special programming only if it is
  176. deemed consequential to the general CLIPPER(tm) public.  Staben Technologies
  177. will not write code for any organization unless it is non-proprietary.  
  178.  
  179.  
  180. CLIPPER is a registered trademark of Nantucket, Inc.
  181.